home *** CD-ROM | disk | FTP | other *** search
/ Aminet 25 / Aminet 25 (1998)(GTI - Schatztruhe)[!][Jun 1998].iso / Aminet / comm / misc / PData352.lha / PData / PData.DOC < prev   
Text File  |  1998-03-10  |  11KB  |  231 lines
  1.                             PDATA DOCUMENTATION
  2.                             -------------------
  3.  
  4.    Release version : 3.52 final
  5.    Date            : Saturday, 3rd February 1995
  6.                      (This textfile was last modified on 10th March 1998)
  7.  
  8.    Copyright © 1993-1995 Deadbeat/The Sharks
  9.                (C64 coding, optimized cable schematics, documentation)
  10.  
  11.    Copyright © 1993 Hude
  12.                (Amiga coding)
  13.  
  14. 1. OVERVIEW
  15.  
  16.    PData is an utility for transfering both binary and text files between
  17.    the C64/C128 and Amiga, employing a high-speed parallel cable. It's 
  18.    about 25 times faster than a null modem cable -- the maximum rate in a
  19.    standard, non-expanded C64 is 2.4Kbps. Best of all, it leaves your
  20.    Amiga's serial port free for other applications; yes, this means that
  21.    while you're porting software over to the C64, you can download more! :)
  22.  
  23. 2. DISTRIBUTION AND DISCLAIMER
  24.  
  25.    PData may be freely distributed as long as all files are included
  26.    intact and as long as no more than a nominal fee is charged to cover
  27.    time and copying costs. PData may NOT be used for commercial purposes
  28.    without a written permission from the author(s). The author(s) can't be
  29.    held liable for any damage directly or indirectly caused by the use or
  30.    misuse of this manual and/or the program it describes. PData is provided
  31.    "as-is" and it is a subject to change without notice.
  32.  
  33.    You will most likely find the latest version of PData from The Sharks
  34.    world wide web homepage, located at http://stekt.oulu.fi/~mysti/the_sharks
  35.    If you like this program, feel free to send the author some e-mail.
  36.  
  37. 3. REQUIREMENTS
  38.  
  39.    The C64 end of PData will work in every C64/C128. The Amiga end of PData
  40.    will - hopefully - work in every model, but Kickstart v37.175 (v2.04) or
  41.    above is required to utilize all features. A special cable between the
  42.    C64 and Amiga is required. The following things are needed for the cable:
  43.  
  44.         - One card edge connector            (C64 user port)
  45.         - One male D-25 connector            (Amiga parallel port)
  46.         - Suitable length of flat cable      (12 wires or more)
  47.  
  48.    Additionally, you'll need the following files for your Amiga...
  49.  
  50.         - Devs:Parallel.device
  51.         - L:Port-handler
  52.         - Libs:Asl.library
  53.         - Libs:Locale.library
  54.  
  55.    This shouldn't be a problem, if you've installed Workbench properly. :)
  56.  
  57. 4. PDATA CABLE SCHEMATICS
  58.  
  59.    C64 user port              Amiga parallel port
  60.  
  61.    Pin      Description       Description      Pin
  62.  
  63.    B        FLAG* ----------- STROBE           1
  64.    C        PB0 ------------- DATA 0           2
  65.    D        PB1 ------------- DATA 1           3
  66.    E        PB2 ------------- DATA 2           4
  67.    F        PB3 ------------- DATA 3           5
  68.    H        PB4 ------------- DATA 4           6
  69.    J        PB5 ------------- DATA 5           7
  70.    K        PB6 ------------- DATA 6           8
  71.    L        PB7 ------------- DATA 7           9
  72.    8        PC* ------------- ACK*             10
  73.    M        PA2 ------------- BUSY             11
  74.    N        GND ------------- GND              17
  75.  
  76.    Inspect the C64 user port's pin order carefully before and after
  77.    soldering. The user's manual provided with the C64 (or C128) helps
  78.    considerably. That is, if you still got it somewhere...
  79.  
  80. 5. USING PDATA C64
  81.  
  82.    Using PData C64 is fairly easy. You'll first be prompted for your work
  83.    drive. Any device between 8 and 11 will do. Then you can select whether
  84.    to handle your files as binary or text. If you select binary, the files
  85.    will be transfered without any alterations. Selecting text mode will
  86.    cause everything to be translated from PETSCII to ASCII and vice versa.
  87.    The next step is to decide whether to send or receive files. At this
  88.    point, you can press "," to access a SEQ file handler, using which you
  89.    can print out or view sequential files. Assuming that you didn't enter
  90.    the SEQ file handler, you now can press F1 to toggle between normal/zip
  91.    mode. If zip mode is on, PData will add those 1! 2! 3! and 4! prefixes
  92.    in front of each zip disk-packed file automatically and you only need
  93.    to worry about fourteen last characters. If you start receiving a file
  94.    in single mode, you'll be prompted whether to process files as PRG or
  95.    SEQ. If a file exists, you'll be given a chance to regret. You can use
  96.    "$" (CR = $ as Default) to see directory, "@" for DOS commands and "?"
  97.    to see number of free blocks available on disk. Pressing "=" at all
  98.    times (Except in multi-file transfer menu) will take you one step
  99.    "backwards" in the menus. In zip mode, you can individually decide
  100.    which of the files should be overwritten. Pressing F3 will take you
  101.    to multi-file transfer menu. In multi-file transfer menu, press F1 for
  102.    sending files, F3 for receiving files, F5 for directory and F7 for main
  103.    menu. After pressing F1, you can use Y/N to select files. Pressing CR
  104.    (Return) will quit or start transfer, depending if you've got any files
  105.    selected. After pressing F3, you can enter target filenames. Leave one
  106.    blank line and hit CR to start transfer. Multi-file transfer can handle
  107.    255 files both directions. It handles only binary PRG files and never
  108.    overwrites it's target files. At ALL times, pressing restore will clear
  109.    the channel, initialize vectors and restart the program. If you're in
  110.    doubt of something, just try it. The chances are, you won't seriously
  111.    damage anything.
  112.  
  113. 6. USING PDATA AMIGA
  114.  
  115.    pdata (s/r/?) (path/filename)
  116.    (s = send / r = receive / ? = help)
  117.    Example : pdata r dh1:dl/c64_rules.txt
  118.  
  119.    Pressing CTRL+C will - hopefully - abort transfer. Use it in combination
  120.    with RESTORE in the C64 end to gain maximum effect. If you have a
  121.    MultiFaceCard (MFC) in your Amiga, remember you must use the PData.CFG
  122.    in S: directory to re-route PAR: into PIT:. Edit the file so that it
  123.    reads PIT:<CR>. If you're using your Amiga from a floppy, I suggest you 
  124.    redirect the files into RAM: when receiving something from the C64.
  125.    Just try to receive something on a floppy, and you'll know why!
  126.    Yes, takes ages, due to a small missing feature: a receive buffer. :(
  127.  
  128. 7. MISCELLANEOUS
  129.  
  130.    Configuring your regular directory tool for PData makes your life much
  131.    easier. I highly recommend DiskMaster 2 myself; it's lightweight and uses
  132.    resources efficiently. You can find it on Aminet: util/dir/DiskMaster.lha
  133.  
  134.    Once you've made the first transfer after turning both of your
  135.    computers on, you can ignore the C64's on-screen prompts about setting
  136.    the other end to send/receive mode. This is because once the Amiga's
  137.    port-handler has been "activated", PData can't "lose" anything. When
  138.    transfering PData mainfile (PDATA.C64) to the C64, you MUST use the
  139.    filename "PDATA 3.5-SHARKS". To transfer the file, try a null modem
  140.    cable. Schematics are supplied below. You'll need a RS-232 adapter for
  141.    the C64 and a suitable terminal program for both ends. If, however, you
  142.    should experience problems in doing so, e-mail me and I'll try to
  143.    help you out.
  144.  
  145. 8. NULL MODEM CABLE SCHEMATICS
  146.  
  147.    Pin     Description       Description       Pin
  148.  
  149.    2       TXD ------------- RXD               3
  150.    3       RXD ------------- TXD               2
  151.    4       RTS ------------- DCD               8
  152.    6       DSR ------------- DTR               20
  153.    7       GND ------------- GND               7
  154.    8       DCD ------------- RTS               4
  155.    20      DTR ------------- DSR               6
  156.  
  157. 9. BUGS AND MISSING FEATURES
  158.  
  159.    C64 end:   - None known, although there has been some reports about
  160.                 problems with multi-file transfers.
  161.  
  162.    Amiga end: - Sometimes refuses to work if a filename ends with "+".
  163.               - Refuses to work if a filename contains any spaces.
  164.               - Receive buffer missing - major slowdown on slow mediums.
  165.                 ...
  166.  
  167.    PData doesn't send a header containing a filename. This is NOT a bug,
  168.    but something that was supposed to be added in the forthcoming release.
  169.    See future, just a few lines below.
  170.  
  171.    Just a little bit on the trivia side, you should know that PData can be
  172.    used to transfer data between two C64's or two Amiga's with minor cable
  173.    modifications. Hardware wizards may figure this one out on their own.
  174.  
  175. 10. FUTURE
  176.  
  177.    This version of PData is the last released one. Even if this documentation
  178.    is revised in march 1998, the program files aren't. The development of
  179.    PData stalled four years ago, simply because the lack of a qualified
  180.    Amiga coder. I coded the entire C64 end of PData from scratch,
  181.    designed a really nice user interface, and fixed most of the flaws
  182.    present in this release. File size, name and some other info were
  183.    supposed to be transfered in a small pre-header. But, without any
  184.    support for these features in the Amiga end, the new fancy features
  185.    are pretty much obsolete, wouldn't you think? The change would've 
  186.    been a radical, dramatic one. Not only in terms of speed, but
  187.    also flexibility, usability and not to forget - reliability.
  188.  
  189.    Still, PData is highly reliable and very stable, as it is. There have
  190.    been some other programs employing the very same cable as PData and
  191.    also parts of the code. The likelihood of these programs ever being
  192.    available to the public is very low. Somehow, people like to keep
  193.    programs of this nature strictly for their own use. That usually
  194.    means non-finished, non-polished programs, with lots of bugs --
  195.    traps waiting to be stumbled into, that the coder himself can
  196.    easily avoid, because he made it for himself. :)
  197.  
  198.    As for resuming the PData project, I don't know. If there's enough
  199.    demand for a program like this, and if a qualified Amiga coder 
  200.    volunteers for the project, then maybe. What the hell, code your
  201.    own PData clone if you like; rip the bare essentials from my code
  202.    and prove you can do better! All I really care about is a program
  203.    that does what it's supposed to -- in this case, transfer data
  204.    between C64 and Amiga reliably and rather fast, too.
  205.  
  206. 11. GETTING IN TOUCH WITH ME...
  207.  
  208.    E-MAIL:        deadbeat@iwn.fi
  209.    WWW:           http://stekt.oulu.fi/~mysti/the_sharks
  210.    IRC:           Deadbeat (Usually on #C-64)
  211.    SNAIL:         (Buah, you've got to be kidding me! Snailmail's DEAD!)
  212.  
  213.    Questions? Comments? Flames? Don't hesitate, drop me some e-mail!
  214.    If you're on IRC, and you see me around, feel free to /msg me.
  215.    I'm on "the European side of the EFNet split", or as it might be
  216.    better known as, IRCNet. There, the channel #C-64 is highly
  217.    recommended for anyone with (some) C64 past.
  218.  
  219.    As far as making PData cables is concerned, I don't have
  220.    time to make any, nor do I know of a voluntary person.
  221.    Consider the making of a PData cable as a lamer-protection! ;)
  222.  
  223.    By the way, if it's C64 stuff you're after, we're offering plenty on
  224.    our web page. Mostly golden oldies, all the best games and demos ever.
  225.    In an emulator-free format, i.e., stored in formats used by the Real
  226.    Thing. Do some exploration on our web page's main index, or go straight
  227.    to http://stekt.oulu.fi/~mysti/the_sharks/online.html
  228.  
  229.    Thank you for reading this far. Hope the program proves useful for you!
  230.    - Deadbeat/The Sharks
  231.